			RASCONN Version 2.5 DOCUMENTATION
                  Copyright (C) 1995-96 Multi-Dimension Technology, Inc.
      		              All Rights Reserved.


Multi-Dimension Technology, Inc.
107-17 79th Street
Ozone Park, NY 11417

Internet:      mdtech@gramercy.ios.com
CompuServe ID: 103462,2353

-----------------------------------------------------------------------------
RASCONN is a third-party VBX written for Shiva remote access.
It comes with a VB sample program that is ready to use.

RASCONN.VBX has custom properties for ID, password, phone number, and more.
It has custom events to notify Connection status and error.  RASCONN.VBX has
custom "methods" in the form of the ACTION Property to perform Connect and 
Disconnect.  Finally it allows you to automate TTY terminal login with 
the use of a *.sr file.  You must have Shiva-Remote installed on your machine
in order to use this VBX.  One good way to test whether Shiva-Remote is
properly installed is by trying to connect using CONNECTW.EXE.  We have 
tested version 3.5 of Shiva-Remote with RASCONN.
     
Copy RASCONN.VBX and CONNAPI.DLL to your VB make file directory
and to the directory where the executable resides.

This VBX allows a Visual Basic program to perform Shiva Remote Access.  It 
shields a VB programmer from worrying about C-language oriented function 
calls.  It has been tested for VB3.0 and 16-bit VB4.0.

1) Features that are in the current version of RASCONN.VBX:

- Properties

Action:  Long.  This property is used as Methods. The reason for this Action
property is because custom methods can't be implemented in a VBX.  There 
are three possible values you can set.  Use value 2 to check connection 
status.  Use value 1 to connect and 0 to disconnect.

EntryName:  String.  Instead of providing login infomation by setting
different properties,  you can tell it the ConnFile (*.sr file) that 
connectw.exe uses.  Leave this property empty if you do not want to use it.  If 
you set the control properties of ShivaID, Phone Number and Password, the control 
ignors the corresponding values in the ConnFile.  The only way to connect to a 
third party security device such as Time Net, will be through the use of a ConnFile 
(*.sr file).

ID:  String.  This is your Shiva login ID.

IP0, IP1, IP2, IP3: Short.  If you string these four properties together, you get 
the IP address for the current connection.  Example:
txtIPAddress.Text = Format(Rasconn1.IP0) & "." & Format(Rasconn1.IP1) & "." & Format(Rasconn1.IP2) & "." & Format(Rasconn1.IP3)

ModemConnectSpeed:  Long.  This property indicates modem speed for the current connection.  
Example: txtModemSpeed.Text = Format(Rasconn1.ModemConnectSpeed, "#,###,###") & " BPS"

ModemLEDS: Boolean.  This property can only be set at design time to be effective due to
a limitation in the underlying.  If it is set to TRUE, RasModemEvent will fire back 
to indicate modem status.

Password: String.  This is your Shiva login password.  If you set this
property at the property window, it will not be saved to the hard drive for
security purpose.

Phone Number:  String.  This is the phone number you dial to login.

PreConnected:  Boolean.  Indicates if a connection is already exist.  This 
property is set when the VBX is first loaded.

Status:  Long.  Indicaties the status of a connection.  It could be 
Connected or Disconnected.  Since Shiva API is still in Beta.  This property
cannot not be counted on.  To find out the status of a connection with guarantee,
trap the lEvent value of ShivaEvent(lEvent as Long, sMessage as String).  See also
the sample program.

There are also Standard properties such as Visible, Width, Tag and so on.


- Methods
See Action Property.


- Events 

RasConnEvent(lEvent as Long, sMessage as String)

The Shiva VBX has a call-back event that notifies your VB program during 
different stages of a connection.  It passes you an event number and a 
string that describes the event. Events such as Initializing Modem, Calling, 
Connecting, Authenticating and Connection Established are sent to the VB 
program through this call-back event.  These events occur asynchronously 
from the VB program.  Using this call-back event, you do not have to 
constantly poll to find out the status of a connection.

RasModemEvent(lModemEvent as Long, sMessage as String)
'The High Speed (HS) bit is set when the modem is connected at 9600 BPS or higher.
Global Const RASCONN_MODEM_LED_HS = &H1

'The Auto-Answer (AA) bit is set when the modem is awaiting the dial-back telephone call from the remote networking server.
Global Const RASCONN_MODEM_LED_AA = &H2

'The Carrier Detect (CD) bit is set when the dial-in connection is up.  It is clear when the connection has not been established, or after the connection is lost.
Global Const RASCONN_MODEM_LED_CD = &H4

'The Off-Hook (OH) bit is set whenever the telephone is off-hook.  The phone is off-hook when it is dialing or connected.
Global Const RASCONN_MODEM_LED_OH = &H8

'The Receive Data (RD) bit is set whenever the ShivaPPP dial-in driver is receiving a network frame from the remote networking server.  It is clear whenever it is not receiving a frame.
Global Const RASCONN_MODEM_LED_RX = &H10

'The Transmit Data (TD) bit is set whenever the ShivaPPP dial-in driver is transmitting a network frame to the remote networking server.  It is clear whenever it is not transmitting a frame.
Global Const RASCONN_MODEM_LED_TX = &H20

Error_Event lErrCode as Long, sErrorStr as String)

If an error occurs, the event will be triggered.


- Sample VB Program using the Shiva VBX.

Using less than 10 lines of VB code with a few buttons and text boxes, this 
VB program demonstrates the features of the Shiva VBX.  It allows you to 
make a connection, disconnect it.  It also displays shiva events in a text 
box.  

